home *** CD-ROM | disk | FTP | other *** search
/ AM/FM: Amiga Musicians' Freeware Magazine 5 / AM-FM 5.adf / utilities / osc.doc.pp / osc.doc
Encoding:
Text File  |  1992-01-01  |  6.4 KB  |  145 lines
  1.  
  2.                Manual for Osc, written 14/10 1991.
  3.     ----------------------------------------------------------
  4.  
  5. Osc is a real-time digital oscilloscope to be used with a mono
  6. 8-bit sampler connected to the parallel port.
  7.  
  8. Osc can be started from CLI or WB. No parameters.
  9. It should work with A500/1000/2000/3000.
  10. Preferably in PAL-mode since it needs 256 scanlines to display all 8 bits
  11. of a waveform.
  12. Features include scanning, trigging, time-measuring and a signal generator.
  13.  
  14.  
  15. NORMAL SCAN MODE
  16. =========================
  17. When started, the program will automatically start scanning at ~32000 Hz.
  18. Now, you can press F1-F10, DEL or HELP to set another sampling frequency.
  19.  
  20. F1=1 kHz   F2=2 kHz   F3=3 kHz   F4=4 kHz   F5=5 kHz
  21. F6=8 kHz   F7=11 kHz  F8=16 kHz  F9=22 kHz  F10=29 kHz
  22. DEL=44 kHz (maximum)  HELP=32 kHz (can be altered).
  23.  
  24. You can also press the right mousebutton to freeze the curve (Checked
  25. before each sweep) The program will connect the dots to form a curve.
  26. Releasing the button will restart the sweep.
  27.  
  28.  
  29. TRIGG SELECT
  30. =================
  31. There is also an option to trigg the curve, (=only allow the sweep to
  32. start at a certain position and moving in a certain direction).
  33. First select the direction with up-arrow or down-arrow. The curve will
  34. freeze immediately and you will get a small horizontal line at the left
  35. edge of the screen. Move this up or down with the mouse to the desired
  36. trigger position and press left mousebutton to restart the sweep.
  37.  
  38. To exit the trigger setting module without setting any position or to
  39. return the oscilloscope to "free run" again, press space.
  40.  
  41.  
  42. TIME/FREQUENCY MEASURING
  43. =============================
  44. Freeze the curve with the right button and while holding it down, press
  45. the left button as well, then release both buttons.
  46. You are now in time/frequency measuring mode. The curve will dim and
  47. two orange vertical lines will appear. Move the right one with left-arrow/
  48. right-arrow and the left one with ">" and "<" (The "." and "," keys)
  49. The program will tell you the time passed between the two marks
  50. in microseconds, milliseconds or seconds, as aproppriate.
  51. It will also consider what you have marked as one cycle of a waveform and
  52. print it's frequency.
  53. You can exit the time/frequency measuring mode with left mousebutton,
  54. space, escape, TAB or tilde (~).
  55.  
  56.  
  57. SIGNAL GENERATOR
  58. =====================
  59. The signal generator is entered by pressing TAB or tilde while in normal
  60. scanning mode. Some text will appear in front of the curve, which will
  61. dim, but continue scanning. You can now walk around the screen with the
  62. arrowkeys. A waveform or a number will be inverted to indicate the position.
  63. There will be two identical sets of four waveforms (sinus, triangle,
  64. squarewave and sawtooth) and two numerical values for frequency and volume.
  65.  
  66. At the bottom of the screen, 11 values are printed. This is the sampling-
  67. frequencies, in kHz that the program will use if you press the keys F1-F10
  68. or DEL. Those keys can be used from within signal generator mode as well.
  69. Just above that line stands a single number. This is the frequency used
  70. when you press the HELP-key. It can be defined to whatever you want in
  71. the range 28 Hz - 44 kHz. Just press down-arrow until the number is
  72. inverted and enter the new value. The first digit you press will erase
  73. the current number and leave only the digit you typed. There will be
  74. no visible cursor. Backspace can be used to correct mistakes.
  75. When finished editing the new value, press return or any arrowkey to
  76. let the program use your new value. It will be checked against the valid
  77. ranges and converted to the closest avaliable value.
  78. The program will always use the Help key's frequency after it has been
  79. edited regardless of which it used before.
  80.  
  81. One of the waveforms on each of the two voices will have a frame around
  82. it to indicate that this is the selected waveform for this voice.
  83. Change this by pressing return while positioned over the desired waveform.
  84.  
  85. The volume and frequency are changed just like the help-frequency.
  86. A frequency of 0 Hz will turn sound DMA off for that voice.
  87. The combined sound of the two voices will be sent to the right sound
  88. output of your Amiga. Please note that all waveforms can't be set to a 
  89. frequency with the same accurracy, if you specify a 100 Hz sinuswave and 
  90. a 100 Hz trianglewave they will not be completely syncronized.
  91. The squarewave has the highest accurracy.
  92.  
  93. 100 Hz sinus    will be output as 100.23346 Hz
  94. 100 Hz triangle will be output as  99.87549 Hz
  95. 100 Hz sawtooth will be output as  99.87549 Hz
  96. 100 Hz square   will be output as  99.99825 Hz
  97.  
  98. If you specify the same waveform and frequency for both voices, perhaps
  99. to get a higher output volume, press "S" for "Sync". This will turn both
  100. voices off and then restart them at the same time. Otherwise they will
  101. be in random phase with each other. You can press return on the
  102. waveform several times to re-generate the sound and get another phase
  103. difference.
  104.  
  105. Sometimes the waveform will fly very quickly over the display and is
  106. very difficult to examine. To avoid this you can temporarily exit the
  107. signal generator with TAB, tilde or escape, set a trigger position and
  108. get back again. Better, perhaps, is to make a "faked" trigg by pressing "T".
  109. This will alter the help-frequency to 320 times the latest specified
  110. frequency, to ideally have one cycle of the waveform over the display.
  111. (It usually drifts somewhat). If 320 times your frequency is too high,
  112. the program will half that value until it gets into the allowed range.
  113. This means you might get 2, 4, 8 etc cycles on the screen.
  114.  
  115. Of course, the curve can be halted with the right mousebutton even in
  116. signal generator mode. If you press both mousebuttons you will not get
  117. into time measuring mode, instead the curve just stops there with no
  118. need to hold down a mouse button. It can be restarted with left mousebutton
  119. or space. If you exit the signal generator with the curve frozen it will
  120. immediately get into time-measuring mode.
  121.  
  122.  
  123. AFTERWORDS
  124. ==============
  125.  
  126. This program is shareware, it may be copied freely provided this
  127. document file follows it. If you find this program useful I would
  128. apperciate if you sent the equivalent of $15 in your currency to
  129. account #691023-0075 at Nordbanken, SWEDEN.
  130.  
  131. Thanks to Arvid Svderberg and Lars Eriksson [Zion] for ideas
  132. to improvements.
  133.  
  134. My Email address:  dvljrt@cs.umu.se
  135.  
  136. Snail:   Joakim Rosqvist
  137.          Stipendiegrdnd 10B-112
  138.          S-90735 Umee
  139.          SWEDEN
  140.  
  141.          Phone +46 090-196574
  142.  
  143. Hope you enjoy this                         /$DR.HEX$
  144.  
  145.